Image Display Registry entry

Specify an image (and sound and hint if required) to display along with Summary Data in a module window.

Note: Details about Image Displays can be found here.

Usage

This Registry entry can be assigned to users and groups:

Key User User Group Group Group Group
Key 1 User User Group Group Group Group
Key 2 user user group group Default Default
Key 3 Table Table Table Table Table Table
Key 4 table Default table Default table Default
Key 5 Image Display
Key 6 column
Key 7 value
Value image[;sound[;hint]]

It is also possible to test for the existence of data in a field rather than for an exact value using the following variations:

Group Default Table table Image Display column value image[;sound[;hint]]
Group Default Table Default Image Display column value image[;sound[;hint]]

where:

column

is the name of the column to check for value. If value is found in column (or is one of the values in a table), the rest of the Registry entry is evaluated.

value

is the value to search for in column. If value is found in column (or is one of the values in a table), the rest of the Registry entry is evaluated.

To be matched, value must be found in column exactly as specified and on its own line / in its own row.

For example, if value = warning and the data in column is:

  • warning, there is a match, e.g.:

  • warnings, there is no match.

  • this is a warning, there is no match, e.g.:

The same holds for rows in a column:

  • This will match:

  • This will not match:

image

is the name of the image file to display. The file must be located on the EMu server in the ~EMu/client/etc/images directory. The image file is cached on the client as required. The image may be any file type supported by the EMu Multimedia Repository (e.g. bmp, png, gif, tiff, tga, pcx, pcd, jpeg, dcx).

sound

is optional. The sound will be played after the image is displayed. The sound file must be located on the EMu server in the ~emu/client/etc/images directory. The sound file must be in .wav format.

hint

is optional. The hint is shown when the mouse cursor hovers over the displayed image. The hint message is multilingual, with the text for the prompt language being used.

NULL

will match an empty column.

NOT NULL

will match a column with data.

Note: It is possible to display multiple images. If the same image would be displayed more than once, only the first instance is shown. Hence it is possible to display just one image display where multiple values are matched. Also the same named sound file will only be played once. See last example below for details.